home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / ab20 / unarced / graphics / hamlabdemo / docs / config.doc next >
Text File  |  1995-03-17  |  4KB  |  135 lines
  1. HamLab Version 1.1
  2. Configuration File Format
  3.  
  4. (c) Copyright 1990, 1991 J. Edward Hanway
  5. All rights reserved.
  6.  
  7. INTRODUCTION
  8.  
  9. The HamLab configuration file is a text file which HamLab uses to determine
  10. what input filters it has available, as well as other miscellaneous
  11. configuration options. Each time HamLab is run, it looks for the
  12. configuration file in the following places, in order:
  13.  
  14.     HamLab.config    (in the current directory)
  15.     DEVS:HamLab.config
  16.     S:HamLab.config
  17.  
  18. FILE FORMAT
  19.  
  20. In the configuration file, A '#' denotes that the rest of the line is a
  21. comment.  Blank lines and lines starting with a '#' are skipped.  All other
  22. lines must contain one of the following commands:
  23.  
  24. Cache12Bit    size (32 bit signed value)
  25.  
  26.     This specifies the maximum size, in bytes, of HamLab's 12-bit
  27.     temporary data that will be kept in RAM. If an image requires more
  28.     room than this value, it will be kept in a temporary file (in
  29.     whatever directory you specify with TempPath).  Some useful values
  30.     to use here are:
  31.         0    -- always use a file
  32.         -1    -- always try to keep it in memory
  33.         130000    -- try to keep 320 x 200 and smaller in memory
  34.  
  35. ColorFile    "file name"
  36.  
  37.     Specifies the name of the default color response curve file that is
  38.     loaded whenever HamLab is started.  The file must be in the
  39.     directory specified by ColorPath.
  40.     
  41. ColorPath    "disk path"
  42.  
  43.     Specifies the default directory where color response curve files
  44.     are kept. (You can load/save color response curves from/to any
  45.     directory; this is just the default value.)
  46.     
  47. ConstrainedScale 0/1
  48. FastAnalyze    0/1
  49. FixBackground    0/1
  50. FreezePalette    0/1
  51. Interlace    0/1
  52. SHAM        0/1
  53. UsePipes    0/1
  54.  
  55.     These (optional) lines specify the initial values for HamLab's
  56.     options.
  57.     
  58. Hsqueeze    0/1 (*)
  59.  
  60.     HSqueeze is obsolete in version 1.1 and will be ignored. Use
  61.     "XScale 50%" instead.
  62.  
  63. DitherType    0-6
  64.  
  65.     Specifies the initial dithering option. The possible values are
  66.     as follows:
  67.         0 -- no dithering
  68.         1 -- Serpentine Floyd-Steinberg 4 term error diffusion
  69.         2 -- Serpentine Jarvis, Judice, & Ninke 12 term error
  70.              diffusion
  71.         3 -- Serpentine Stucki 12 term error diffusion
  72.         4 -- 4x4 Dispresed Dot Ordered Dither
  73.         5 -- Random Dither
  74.         6 -- 4x4 Spiral Clustered Dot Ordered Dither 
  75.  
  76. FilterPath    "disk path"
  77.  
  78.     Specifies the disk path where the filter programs can be found.
  79.  
  80. Format        "matchstring" "filtername"
  81.  
  82.     One of these lines must be present for every input filter. The
  83.     first string is the pattern which identifies that type of file.
  84.     The second is the name of the filter program.
  85.  
  86. Gamma        x.y
  87.  
  88.     Specifies the initial Gamma value.  The value must be a value
  89.     between    0.1 and 9.9, and must be in the following exact form:
  90.     digit, decimal point, digit.
  91.     
  92. InPath        "disk path"
  93. OutPath        "disk path"
  94.  
  95.     These set the initial directories for the input and output file
  96.     requesters. (Of course, you can read and write from/to any
  97.     directory; these are just for convenience.)
  98.  
  99. TempPath    "disk path"
  100.  
  101.     Specifies the disk path where any temporary file(s) will be
  102.     created.
  103.  
  104. XScale        num[%]
  105. YScale        num[%]
  106.  
  107.     These specify the initial scaling values.  If the number is
  108.     followed immediately (no spaces) by a percent sign, it is a
  109.     percentage, otherwise, it is a fixed size.
  110.  
  111.     
  112. SUGGESTED CONFIGURATIONS
  113.  
  114. If you've got memory to burn, leave UsePipes turned off, set TempPath to 
  115. RAM: and set Cache12Bit to -1. This will keep both 24-bit and 12-bit
  116. temporary images in memory.  Beware, though, a 640 x 480 image will take
  117. up about 1.5 MEGS just in temporary files.
  118.  
  119. If you're short on memory, turn UsePipes on, set TempPath to a disk
  120. directory (a hard disk is nice, but not necessary) and set Cache12Bit to
  121. something low, like 0.  This will eliminate the 24 bit file and keep the
  122. 12-bit temporary file on disk.  If you then save a picture without
  123. displaying it first, then HamLab will only need a few lines of the picture
  124. in memory at a time.
  125.  
  126. Setting TempPath to a RAM disk may be useful.  Even though that means that
  127. temporary files will be kept in RAM, they won't require one huge continuous
  128. chunk of memory.
  129.  
  130. Setting a TempPath is important, even if you set Cache12Bit large enough
  131. that temporary files are normally kept in memory.  If HamLab cannot
  132. allocate a large enough chunk of memory for the image, it will
  133. automatically use a file instead.
  134.  
  135.